home *** CD-ROM | disk | FTP | other *** search
/ Super PC 27 / Super PC 27 (ClarisWorks y shareware).iso / spc / util / executor / docs / faq < prev    next >
Encoding:
Text File  |  1995-03-18  |  38.3 KB  |  953 lines

  1.     FAQ for Executor [last updated 95-02-22]
  2.  
  3. This set of answers to Frequently Asked Questions is not designed to
  4. take the place of our Executor manual.  However, currently our manual
  5. is not available on-line, so this FAQ does briefly touch on some
  6. issues that are covered more in depth in our manual.
  7.  
  8. In addition to this FAQ, there should be README files bundled with
  9. Executor and there is also an Executor/DOS document that describes how
  10. to get started with Executor/DOS from a DOS user's point of view,
  11. which may be useful to users of Executor on other platforms as well.
  12. That document is called "ERNSTOUD.TXT", since it's hard to come up
  13. with useful names when constrained by the DOS 8.3 filename limits and
  14. the author of the document is Ernst J. Oud.
  15.  
  16. Changes in this issue of the FAQ are denoted with ">>" in the beginning
  17. of a line.
  18.  
  19. [1] Executor in General
  20.  
  21.     [1.1]  What is Executor?
  22.     [1.2]  On which platforms is Executor available?
  23.     [1.3]  Who makes Executor?
  24.     [1.4]  Pronunciation?
  25.     [1.5]  Does Executor require you to obtain ROMs or System Files
  26.         from Apple?
  27.     [1.6]  How long has Executor been in development?
  28.     [1.7]  What techniques were used to rewrite the OS and Toolbox?
  29.     [1.8]  What limitations does Executor have?
  30.     [1.9]  Does Executor run all applications?
  31. >>      [1.10]  What do the various Executor version numbers mean?
  32. >>      [1.11]  Where can I pick up the Executor demos?
  33. >>      [1.12]  Is Executor shareware?
  34. >>      [1.13]  How do the demo versions differ from the commercial versions?
  35.     [1.14]  What's next?
  36.     [1.15]  When will 2.0 be out?
  37.     [1.16]  How can I get in ARDI's beta program?
  38.     [1.17]  Does Executor have networking support?
  39.     [1.18]  How do you install Fonts and Desk Accessories (DAs)?
  40.     [1.19]  Will Desk Accessories work under Executor?
  41.     [1.20]  Does E/D run xxx?
  42. >>      [1.21]  What's the best way to keep informed about Executor?
  43.     [1.22]  Why shouldn't I send e-mail to ctm@ardi.com?
  44.     [1.23]  What is an ".hfv" file?
  45. >>      [1.24]  Can I launch apps directly from the command line?
  46. >>      [1.25]  What are all the command line switches?
  47.     [1.26]  Can I have Executor use more than 8Mb for the application zone?
  48.     [1.27]  An app I'm trying crashes.  What should I do?
  49. >>      [1.28]  How do Executor's "license keys" work?
  50. >>      [1.29]  Don't your "license keys" allow people to pirate Executor?
  51. >>      [1.30]  I want to bundle Executor on a CD-ROM.  Can I do that?
  52.  
  53. [2] Executor/DOS
  54.  
  55.     [2.1]  Which FTP sites will carry stable versions of the E/D demo?
  56.     [2.2]  What are the hardware requirements for Executor/DOS?
  57.     [2.3]  What do I do if my Super VGA card isn't VESA compliant?
  58.     [2.4]  Executor crashes with "GrSetMode ; unknown adapter type
  59.          in driver."
  60.     [2.5]  Does E/D require an ASPI driver to access SCSI?
  61.     [2.6]  Have you released Executor for OS/2 yet?
  62.     [2.7]  Why won't Executor/DOS work with my Diamond Viper PCI card?
  63.  
  64. [3] Executor/Linux
  65.  
  66. >>      [3.1]  Can I buy the Linux version now?
  67. >>      [3.2]  Why can't the Linux version access floppies with option-shift-2
  68. >>      [3.3]  Are we ready to hear about Executor/Linux bugs?
  69.     [3.4]  Should bug reports be sent one at a time or in a big list?
  70. >>      [3.5]  Why is there no Executor for NetBSD or FreeBSD?
  71. >>      [3.6]  Where are the bitmaps stored on the Linux version of executor?
  72.     [3.7]  Will there be an SVGALIB version of E/L in the future?
  73. >>      [3.8]  Why do all the non-Executor Windows get creepy colors when
  74.         Executor is running?
  75. >>      [3.9]  How does printing work under Executor/Linux?
  76.     [3.10] Why does Executor complain that it cannot find 'libXt.so.6'?
  77.  
  78. [4] Executor/NEXTSTEP
  79.  
  80. >>      [4.1]  Why hasn't there been an Executor/NEXTSTEP release in a while?
  81.  
  82.  
  83. [1.1]  What is Executor?
  84. ------------------------
  85.  
  86.     Executor is a commercial emulator that allows non-Macintosh
  87.     hardware to run some applications originally written on a
  88.     Macintosh.  Executor has many limitations, see below.
  89.  
  90.  
  91. [1.2]  On which platforms is Executor available?
  92. ------------------------------------------------
  93.  
  94.     Executor/DOS (E/D) is an implementation that runs under
  95.     DOS and Windows.  Executor/NEXTSTEP (E/NS) is an implementation
  96.     that runs under NEXTSTEP, both on original NeXT hardware
  97.     and Intel based hardware running NEXTSTEP.  Executor/Linux
  98.     is an implementation that runs under Linux, using X-Windows.
  99.  
  100.  
  101. [1.3]  Who makes Executor?
  102. --------------------------
  103.  
  104.     ARDI                            questions@ardi.com
  105.     Suite 4-101
  106.     1650 University Blvd., NE
  107.     Albuquerque, NM  87102
  108.  
  109.     +1 505 766 9115 Phone           +1 505 247 1899 FAX
  110.  
  111.  
  112. [1.4]  Pronunciation?
  113. ---------------------
  114.  
  115.     Ig-zek'-yu-tor
  116.  
  117.  
  118. [1.5]  Does Executor require you to obtain ROMs or System Files from Apple?
  119. ---------------------------------------------------------------------------
  120.  
  121.     No.  Executor reimplements from scratch the Macintosh
  122.     Operating System and Toolbox.
  123.  
  124.  
  125. [1.6]  How long has Executor been in development?
  126. -------------------------------------------------
  127.  
  128.     Work began in September of 1986.
  129.  
  130.  
  131. [1.7]  What techniques were used to rewrite the OS and Toolbox?
  132. ---------------------------------------------------------------
  133.  
  134.     Entirely clean-room techniques.  That is to say none of the
  135.     Apple ROMs or Apple System File were ever disassembled.
  136.     Instead ROMlib (the section of Executor that emulates the OS
  137.     and Toolbox) was written from the manuals "Inside Macintosh",
  138.     and Tech. notes.  That isn't sufficient to get the degree of
  139.     compatibility that we need, so tests were written and run on
  140.     Macs to see what a real Mac would do.  In addition, we run
  141.     applications under Executor and when they deviate from how
  142.     they would behave on a Mac, we take a look at what is going on
  143.     and fix Executor accordingly.
  144.  
  145.  
  146. [1.8]  What limitations does Executor have?
  147. -------------------------------------------
  148.  
  149.     Because the OS and Toolbox have been rewritten from scratch,
  150.     Executor has many limitations, including no AppleTalk, no
  151.     sound, no System 7, no INITs, no CDEVs and no
  152.     Internationalization.  Executor can read and write 1.4 Mb Mac
  153.     formatted floppy disks, but can not format floppies, nor can
  154.     it read or write 800 Kb floppy disks.
  155.  
  156.     E/NS can access the serial ports and can print, E/D and
  157.     E/L can not.
  158.  
  159.  
  160. [1.9]  Does Executor run all applications?
  161. ------------------------------------------
  162.  
  163.     Currently, no.  In addition to applications that won't run
  164.     because they require something that we currently don't
  165.     support (e.g.  System 7), due to our rewriting of the OS
  166.     and Toolbox, there is room for enough incompatibility that
  167.     many large programs do not work.  For this reason, we make
  168.     demo versions of Executor available for potential customers
  169.     to run before purchasing Executor (see below).
  170.  
  171.     We are in the process of cataloging what we have tested
  172.     and will include that as appendix A.
  173.  
  174.  
  175. [1.10]  What do the various Executor version numbers mean?
  176. ----------------------------------------------------------
  177.  
  178.     Any 1.x release other than 1.99 is a black and white release.
  179.     Any release that ends in a lower case letter is technically an
  180.     "experimental" release.  In general, experimental releases are
  181.     pre-beta or beta releases that will eventually be released
  182.     with a higher version number.
  183.  
  184.     The most recent non-experimental release of Executor/NEXTSTEP
  185.     is version 1.3.  The most recent non-experimental release of
  186.     Executor/DOS is 1.2.  There has not yet been a
  187.     non-experimental release of Executor/Linux.
  188.  
  189.     Currently, with the recent addition of color support to
  190.     Executor, Executor is experimental for all platforms.  We are
  191.     trying to release new versions for all platforms in lockstep,
  192.     so 1.99b has roughly the same feature set and bug set under
  193.     DOS, Linux and NEXTSTEP.  Unfortunately, we haven't released
  194.     a NEXTSTEP release in a while; see [4.1] for an explanation.
  195.  
  196.  
  197. [1.11]  Where can I pick up the Executor demos?
  198. -----------------------------------------------
  199.  
  200.     As long as they put up with us, the most up to date
  201.     experimental versions of Executor can be found on
  202.     ftp.cs.unm.edu in /pub/ardi.  However, ftp.cs.unm.edu does not
  203.     have the bandwidth to accept many simultaneous users, so when
  204.     we're happy with the stability of one of our color
  205.     experimental versions, we'll make that version available on
  206.     the traditional sites for commercial demos of the given
  207.     platform.  See the platform specific answers for a list of
  208.     these sites.
  209.  
  210.     We are currently working on setting up ftp.ardi.com and
  211.     www.ardi.com, but they are not yet ready.
  212.  
  213.     We don't mind people making our current experimental versions
  214.     available on other sites, but *please* be sure to include all
  215.     the READMEs and FAQs which will allow users to find more
  216.     current versions of Executor as they're released.
  217.  
  218.  
  219. [1.12]  Is Executor shareware?
  220. ------------------------------
  221.  
  222.     No.  Executor is a commercial program available from ARDI.
  223.     Unregistered demo versions are the only versions that should
  224.     be found on bulletin boards or FTP sites.  If you find a
  225.     non-limited version of Executor available to download, it was
  226.     put there illegally.
  227.  
  228.  
  229. [1.13]  How do the demo versions differ from the commercial versions?
  230. ---------------------------------------------------------------------
  231.  
  232.     Prior to Executor 1.99j, ARDI released two separate versions
  233.     of each Executor/DOS and Executor/Linux release: a
  234.     time-limited demo, and a full-fledged commercial version.
  235.     NEXTSTEP versions could be "unlocked" by entering a serial
  236.     number and registration key purchased from ARDI.
  237.  
  238.     See [1.28] for more information.
  239.  
  240.     The E/D, E/L and E/NS "locked" demos are time limited to ten
  241.     minutes of use.  Once your ten minutes are up, you are thrown
  242.     out, but you can restart the program again and run for another
  243.     ten minutes if you'd like.
  244.  
  245.  
  246. [1.14]  What's next?
  247. --------------------
  248.  
  249.     Our immediate goal is to get Executor 2.0 out.  Back before
  250.     1.99 was out, we had a set of goals for what would be in 2.0.
  251.     We have had enough trouble implementing 32-bit color QuickDraw
  252.     that we have had to pare some features out of what we had
  253.     orginally proposed for the 2.0 feature set.  Features present
  254.     in 2.0 are *still* subject to change, but our current plans
  255.     are to add:
  256.  
  257.         A file browser -- we've written one in house.  We will
  258.         be releasing it with source.
  259.  
  260.         Better documentation
  261.  
  262.         The ability to change the screen "depth" (number of colors
  263.         that can be present at one time on the screen) and size
  264.         on the fly.
  265.  
  266.         A simpler method for installing fonts and Desk Accessories
  267.  
  268.         A better set of demo and utility programs
  269.  
  270.     We also have a set of general and platform specific bugs that
  271.     we need to have fixed before we can freeze 2.0.
  272.  
  273.     Beyond 2.0, we want to make Executor compatible with Apple's
  274.     System 7.5, so you'll be able to purchase a copy of System
  275.     7.5, install it on top of Executor and get even more
  276.     compatibility and features.
  277.  
  278.  
  279. [1.15]  When will 2.0 be out?
  280. -----------------------------
  281.  
  282.     The answer here is embarrassing.  Our original target was
  283.     summer of 1994.  With the experimental releases coming out
  284.     regularly, there is a light at the end of the tunnel, but we
  285.     can't say exactly when it will be.  We had some
  286.     miscommunication with our investors that prevented us from
  287.     working very efficiently in the spring, summer and fall of
  288.     1994.  It looks like we've got that cleaned up now.
  289.  
  290.  
  291. [1.16]  How can I get in ARDI's beta program?
  292. ---------------------------------------------
  293.     
  294.     Our beta program is really boring.  The only thing that you
  295.     get that you can't get over the net is an actual set of
  296.     floppies that contain installation scripts.  As such, we
  297.     really don't need new beta members.  Just pick up the
  298.     experimental versions and keep us informed.
  299.  
  300.     
  301. [1.17]  Does Executor have networking support?
  302. ----------------------------------------------
  303.  
  304.     Currently, no.  Nor, will it be available in Executor 2.0.
  305.     Networking support is planned for release 3.0, but we do not
  306.     yet have an estimated date of completion for 3.0.  The first
  307.     platform to have networking support built in will probably be
  308.     Linux.
  309.  
  310.  
  311. [1.18]  How do you install Fonts and Desk Accessories (DAs)?
  312. ------------------------------------------------------------
  313.  
  314.     The short answer is "wait for our new file browser that will
  315.     allow you to install fonts and DAs via drag and drop."
  316.     However, if you are an old time Macintosh user and you have a
  317.     copy of Font/DA Mover on a Mac, you can copy the Executor
  318.     System file over to a Mac, install the Fonts/DAs over there
  319.     and then bring the System file back to Executor.  This is
  320.     tricky and not for the faint of heart.
  321.  
  322.  
  323. [1.19]  Will Desk Accessories work under Executor?
  324. --------------------------------------------------
  325.  
  326.     Currently Desk Accessory support is very weak; most will not
  327.     run.  After we get the browser released that allows easy
  328.     installation and removal of desk accessories, we'll spruce up
  329.     our DA code and work on insuring that some of the more popular
  330.     DAs work.
  331.  
  332.  
  333. [1.20]  Does E/D run xxx?
  334. -------------------------
  335.  
  336.     With all the rush to get 2.0 out the door ASAP, we're
  337.     putting our testing people to work testing new experimental
  338.     versions, instead of testing 1.2.  There is plenty that
  339.     1.2 will not run, and as such, we recommend people try out
  340.     the demo before purchasing Executor.
  341.  
  342.     We will be making a list of what runs and what doesn't available
  343.     as part of this document as Appendix A, but that information is
  344.     not available in this release of the FAQ.
  345.  
  346.  
  347. [1.21]  What's the best way to keep informed about Executor?
  348. ------------------------------------------------------------
  349.  
  350.     Join the Executor mailing list.  Send a message to
  351.     "executor-request@nacm.com".  Make sure your subject line is blank
  352.     and your message body says:
  353.  
  354.     subscribe
  355.  
  356.     We try to post important events to the net, and send new
  357.     release information via U.S. mail to our current customers,
  358.     but the Executor mailing list is where we post news about our
  359.     experimental versions and where you can send mail to talk with
  360.     other people who are using Executor.
  361.  
  362.     If you'd rather get the Executor Interest information in a
  363.     daily digest form, send the same subscribe message to
  364.     "executor-digest-request@nacm.com", instead of
  365.     "executor-request@nacm.com".
  366.  
  367.     To remove yourself from either mailing list, send a message to
  368.     the address that you used to subscribe, saying:
  369.  
  370.     unsubscribe
  371.  
  372.     This will work only if you send the unsubscribe message from
  373.     the same account that you used to send the subscribe message.
  374.     You can also send a message of "help" to executor-request and more
  375.     information about how to use it will be e-mailed to you.  If
  376.     you are still having trouble, you can send e-mail to
  377.     "majordomo-owner@nacm.com" and that will be processed by a
  378.     person, although it may take a few days for the person to get
  379.     around to to your request.
  380.  
  381.     Even after you have unsubscribed to the list, you will
  382.     continue to get any messages that were posted to the list
  383.     before you unsubscribed but were not actually sent
  384.     immediately, but once you have unsubscribed, any new messages
  385.     that come in will not be sent to you.
  386.  
  387.     The Executor Interest mailing list is administered by a
  388.     volunteer.  We do not directly control the list.  Lately there
  389.     has been a request that we operate a mailing list for
  390.     announcements only.  Although we can't provide that right now,
  391.     we're hoping the digestification will make such a separate
  392.     list much less needed.
  393.  
  394.  
  395. [1.22]  Why shouldn't I send e-mail to ctm@ardi.com?
  396. ----------------------------------------------------
  397.  
  398.     Cliff gets tons of e-mail.  E-mail sent to questions@ardi.com
  399.     is answered much more punctually.
  400.  
  401.  
  402. [1.23]  What is an ".hfv" file?
  403. -------------------------------
  404.  
  405.     Executor has the ability to store an entire Macintosh "volume"
  406.     (i.e. filesystem corresponding to a disk drive or a partition
  407.     within a disk drive) in a DOS or UNIX file.  Under DOS, this
  408.     feature is very handy because there is no way to have files
  409.     with long names and upper and lower case characters in their
  410.     names unless you use a ".hfv" file.
  411.  
  412.  
  413. [1.24]  Can I launch apps directly from the command line?
  414. ---------------------------------------------------------
  415.  
  416.     Yes.  If an app resides within a UNIX or DOS filesystem, you
  417.     can specify the name of the app, and documents that you would
  418.     like the app to open when it starts up, on the command line.
  419.  
  420.     Apps that reside in ".hfv" files can't currently be launched
  421.     from the command line.  This will change soon.
  422.  
  423.  
  424. [1.25]  What are all the command line switches?
  425. -----------------------------------------------
  426.  
  427.     NOTE:  we are currently in the process of revamping how executor
  428.         processes command line switches.  This should allow
  429.         us to have much less confusing documentation.
  430.            
  431.  
  432.     Switch      Min     Max     Default         Default when switch
  433.                             is present, but with no
  434.                             value specified
  435.  
  436.     bpp         1       8       8               8
  437.     refresh     0       60      0               10
  438.     shadow      0       1       0               1
  439.  
  440.     nosplash    0       1       0               1
  441.     debug       0       10      0               10
  442.  
  443.     noclock     0       1       0               1
  444.     noint8      0       1       0               1
  445.  
  446.     drivecheck  0       1       0               1
  447.  
  448.     nomouse     0       1       0               1
  449.  
  450.     applzone    128     8192    1024            2048
  451.     syszone     128     4096    512             1024
  452.     stack       64      4096    256             128
  453.  
  454.     size        512x342 varies  640x480         illegal
  455.  
  456.     nativecode  0       1       1               1
  457.  
  458.     Additional Linux/X windows options
  459.     ----------------------------------
  460.     privatecmap
  461.     invertedcursorbug
  462.     geometry
  463.     synchronous
  464.  
  465.     The switches bpp, refresh and shadow all affect how the screen
  466.     is emulated.  The number of bits per pixel that the program
  467.     running under Executor sees is specified by bpp.  If bpp is
  468.     set to 1, then there are only two "colors" (black and white)
  469.     available.  If it is set to 8, then 256 colors are available.
  470.     For Executor/DOS, you need a SVGA board with a VESA compatible
  471.     driver to get 8 bits per pixel and screen sizes larger
  472.     than 640x480.
  473.  
  474.     When Executor first starts up, a "splash screen" is printed.
  475.     You can omit this splash screen with the nosplash switch.
  476.  
  477.     Sometimes Executor detects potential errors that may be useful
  478.     for us to see when we try to figure out why a given program
  479.     won't run under Executor the debug option controls the
  480.     printing of these error messages.
  481.  
  482.     One of the hardest things to emulate properly is the internal
  483.     timing mechanisms of a Macintosh.  Sometimes it is desirable
  484.     to turn off our clock emulation.  Both noclock and noint8 do
  485.     this, although in slightly different ways.
  486.  
  487.     When Executor displays a standard "get" or "put" dialog box,
  488.     there is a button marked "drive" that allows you to cycle
  489.     through the Macintosh volumes that Executor knows about.  You
  490.     can use the drivecheck switch to have Executor examine your
  491.     DOS drives each time you click the "drive" button.  In
  492.     general, this is more annoying than it is useful.
  493.  
  494.     Although Executor is almost totally useless without a mouse,
  495.     Executor/DOS can be started without a mouse if you use the
  496.     nomouse switch.  If you don't use that switch and you don't
  497.     have a mouse, Executor/DOS will politely tell you that you
  498.     can't run Executor.
  499.  
  500.     The switches applzone, syszone and stack control how much
  501.     memory is allocated to the application, the system, and the
  502.     application stack.  In general, if you have more memory,
  503.     you should override the default applzone and allow Executor
  504.     to use more memory.
  505.  
  506.     For X windows users, privatecmap specifies that Executor
  507.     should use a private colormap.  This is the fastest graphics
  508.     mode and gives you the most accurate colors, but at the
  509.     expense of radically changed colors in your other windows
  510.     whenever the cursor is in the Executor window, and radically
  511.     changed colors in the Executor window whenever the cursor is
  512.     outside of it.  Because this is annoying, this mode is not the
  513.     default. When not in this mode, the pixels in Executor's
  514.     internal frame buffer are converted to the nearest X colors
  515.     before being drawn to the screen.
  516.  
  517.     Executor 1.99<x> uses a new "synthetic CPU" which is much
  518.     faster than the synthetic CPU in previous releases of
  519.     Executor.  The speed increase is due to our use of native
  520.     code; Executor now translates the 68k code being emulated into
  521.     80x86 code "on the fly" and runs the 80x86 code.  However,
  522.     like anything that is new, there's a chance that our
  523.     improvement has some hidden drawbacks.  You can turn off the
  524.     use of native code by specifying nativecode 0.
  525.  
  526.     Here is an example of some of those switches:
  527.  
  528.         executor -applzone 4096 -noclock -nativecode 0
  529.  
  530.     That would allocate 4 Mb of memory for the applications use,
  531.     turn off our clock emulation and revert to a slower type of
  532.     68LC040 emulation -- an unlikely combination of switches.
  533.  
  534.  
  535. [1.26]  Can I have Executor use more than 8Mb for the application zone?
  536. -----------------------------------------------------------------------
  537.  
  538.     Currently, no.  We are reorganizing our memory layout to allow
  539.     you to do this in the future.
  540.  
  541.  
  542. [1.27]  An app I'm trying crashes.  What should I do?
  543. -----------------------------------------------------
  544.  
  545.     Perhaps the most common avoidable cause of crashes is
  546.     insufficient memory for the emulated application.  You can fix
  547.     this by increasing the "applzone" parameter.  For example,
  548.     many programs which normally die quickly will work with
  549.     "executor -applzone 4096" (which allocates 4Mb of space for
  550.     the emulated application; see the list of command line
  551.     switches and their meanings elsewhere in this document).
  552.  
  553.     Some programs are unhappy when they discover that Executor
  554.     does not provide sound support, and crash.  You can turn on
  555.     the "pretend sound" option before running the application in
  556.     question and see if this helps.
  557.  
  558.     The "noclock" switch has also been known to help.
  559.  
  560.  
  561. [1.28]  How do Executor's "license keys" work?
  562. -------------------------------------------
  563.  
  564.     We have now added this "unlocking" capability to the DOS and
  565.     Linux versions.  NEXTSTEP versions have always had license
  566.     keys.  Now any Executor owner can pick up the latest Executor
  567.     release from the Internet, "unlock" it with his serial number
  568.     and registration key, and take advantage of the latest
  569.     features and bug fixes.  This does not mean that all future
  570.     upgrades will be available for free in this mode, but we
  571.     intend to make "minor" upgrades free.
  572.  
  573.     The "unlocking" process actually modifies your copy of
  574.     Executor, stamping *your* serial number into it permanently.
  575.     For this reason, once you have registered a copy of Executor,
  576.     you may not redistribute it, nor should you leave it on an
  577.     unprotected machine, where someone may illegally copy it.
  578.  
  579.  
  580. [1.29]  Don't your "license keys" allow people to pirate Executor?
  581. ------------------------------------------------------------------
  582.  
  583.     No.  If the proper license fee has not been paid to ARDI, then
  584.     the use of a fully registered copy of Executor is illegal, no
  585.     matter how it was acquired.  It is true that since license
  586.     serial number, authorization key pairs are small bits of text,
  587.     it is easier to disseminate unauthorized serial key pairs than
  588.     it is to disseminate unauthorized Executor binaries, but
  589.     that's beside the point.
  590.  
  591.     We decided to use serial numbers and authorization keys as a
  592.     convenience to our customers, especially while we're still
  593.     pressing toward the release of 2.0 and each new experimental
  594.     copy is (usually!) much better than the one that preceeded it.
  595.     We prefer prosecuting the pirates to punishing our patrons.
  596.  
  597.     Our demo mode allows the honest person to evaluate our product
  598.     before making the decision to purchase it and become a
  599.     customer.  The use of an authorization key allows our
  600.     customers to automatically participate in our beta and even
  601.     pre-beta testing.  This leads to faster development cycles and
  602.     a better product.
  603.  
  604.     
  605. [1.30]  I want to bundle Executor on a CD-ROM.  Can I do that?
  606.  
  607.     The short answer is "yes".
  608.  
  609.     You are able to freely copy and distribute demo versions of
  610.     Executor, as long as you follow the restrictions set forth in
  611.     Executor's license panel:
  612.  
  613.       Complete, unregistered distributions of Executor may be
  614.       copied and redistributed as long as all copies are
  615.       unmodified and contain all of the original files in their
  616.       entirety.  Once it is registered, Executor may be copied
  617.       only for backup purposes.  Licensee may not modify or create
  618.       derivative works based on Executor or any part thereof.
  619.  
  620.     A suggestion: contact us to make sure you have the latest
  621.     version of Executor.  We can also tell you if a new release is
  622.     imminent.
  623.     
  624.  
  625. [2]  Executor/DOS
  626. =================
  627.  
  628. [2.1]  Which FTP sites will carry stable versions of the Executor/DOS demo?
  629. ---------------------------------------------------------------------------
  630.  
  631.     Currently the most recent "stable" version of Executor/DOS is
  632.     1.2.  That version is black and white, doesn't run as much
  633.     software as 1.99j does, and is much slower.
  634.  
  635.     E/D is available from the SimTel mirrors.  The primary
  636.     SimTel mirror is oak.oakland.edu, and you can find the
  637.     Executor/DOS demo within the "SimTel/msdos/emulator"
  638.     directory.  It comes in four pieces: exctr12?.zip where ?
  639.     represents the letters a,b,c and d.
  640.  
  641.     Other SimTel mirrors are:
  642.  
  643.      St. Louis, MO:  wuarchive.wustl.edu (128.252.135.4)
  644.              /systems/ibmpc/msdos
  645.      Corvallis, OR:  archive.orst.edu (128.193.2.13)
  646.              /pub/mirrors/simtel/msdos
  647.      Australia:  archie.au (139.130.4.6)
  648.              /micros/pc/oak
  649.        England:  src.doc.ic.ac.uk (146.169.2.10)
  650.              /pub/packages/simtel
  651.        Finland:  ftp.funet.fi (128.214.248.6)
  652.              /pub/msdos/SimTel
  653.         France:  ftp.ibp.fr (132.227.60.2)
  654.              /pub/msdos
  655.        Germany:  ftp.uni-paderborn.de (131.234.2.32)
  656.              /SimTel/msdos
  657.      Hong Kong:  ftp.cs.cuhk.hk (137.189.4.57)
  658.              /pub/simtel/msdos
  659.         Israel:  ftp.technion.ac.il (132.68.1.10)
  660.              /pub/unsupported/dos/simtel
  661.         Poland:  ftp.cyf-kr.edu.pl (149.156.1.8)
  662.              /pub/mirror/msdos
  663.         Sweden:  ftp.sunet.se (130.238.127.3)
  664.              /pub/pc/mirror/SimTel/msdos
  665.     Switzerland:  ftp.switch.ch (130.59.1.40)
  666.              /mirror/msdos
  667.         Taiwan:  NCTUCCCA.edu.tw (140.111.1.10)
  668.              /PC/simtel
  669.       Thailand:  ftp.nectec.or.th (192.150.251.32)
  670.              /pub/mirrors/msdos
  671.  
  672.     If you have AFS, you can pick up Executor/DOS demo 1.2 by
  673.     changing directories to
  674.     /afs/umich.edu/group/itd/archive/msdos/emulators/macintosh.
  675.  
  676.  
  677. [2.2]  What are the hardware requirements for Executor/DOS?
  678. -----------------------------------------------------------
  679.  
  680.     For Executor/DOS 1.2 you need a '386 or better, VGA, 7 Mb disk
  681.     space, a 3.5" 1.44 Mb floppy drive, and 4 Mb RAM.  A SCSI
  682.     Controller is needed only if you want to access external
  683.     Macintosh hard disks or PowerBooks.
  684.  
  685.     Executor/DOS 1.99<x> should work in sixteen colors on any VGA,
  686.     although we do not have the facilities to test more than a few
  687.     in house.  In addition, if you have a Super VGA that is "VESA
  688.     compliant", Executor/DOS should be able to provide 256 colors
  689.     and a range of screen sizes.
  690.  
  691.  
  692. [2.3]  What do I do if my Super VGA card isn't VESA compliant?
  693. --------------------------------------------------------------
  694.  
  695.     There is a shareware SVGA utility that provides VESA compliance
  696.     for SVGA cards that normally are not VESA compliant.  At the time
  697.     this FAQ was last modified, univbe50.zip was the most recent
  698.     release of this extender.
  699.  
  700.     It is not a product of ARDI, but as a convenience to people
  701.     picking up experimental versions of Executor, the file
  702.     univbe50.zip is available in
  703.     ftp.cs.unm.edu:/pub/ardi/Executor_DOS.  If you use it, you
  704.     should pay the shareware fee as described in the documentation
  705.     included in the zip file.  If you have a recent SVGA card you
  706.     probably don't need univbe.  There may be a more recent
  707.     version of univbe in oak.oakland.edu:/SimTel/msdos/graphics.
  708.     This directory also has several other card specific VESA
  709.     drivers, some of which can be found in vesa-tsr.zip and
  710.     vesadrv2.zip.
  711.  
  712.  
  713. [2.4]  Executor crashes with "GrSetMode ; unknown adapter type in driver."
  714. --------------------------------------------------------------------------
  715.  
  716.     You must be running an old version of Executor; this error
  717.     cannot occur in versions >= 1.99h.
  718.  
  719.     1.99b had problems when Microsoft's display.sys driver is in
  720.     config.sys.  We have updated the code that had this problem
  721.     and hope that the problem is now fixed.  If it is not, you
  722.     must remove display.sys from the config.sys section you use
  723.     when you're using Executor/DOS.  Please report this bug if you
  724.     see it in E/D 1.99e or later.
  725.  
  726.  
  727. [2.5]  Does E/D require an ASPI driver to access SCSI?
  728. ------------------------------------------------------
  729.  
  730.     If your SCSI drivers patch the "INT 13" BIOS calls, then an
  731.     ASPI driver is not needed.  As long as "INT 13" can allow Executor
  732.     to read a SCSI drive, there is no need to use ASPI.
  733.  
  734.  
  735. [2.6]  Have you released Executor for OS/2 yet?
  736. -----------------------------------------------
  737.  
  738.     We plan on making an OS/2 specific version of Executor, but only
  739.     after we get Executor 2.0 shipping
  740.  
  741.  
  742. [2.7]  Why won't Executor/DOS work with my Diamond Viper PCI card?
  743. ------------------------------------------------------------------
  744.  
  745.     Executor/DOS requires VESA compliant graphics cards.  Many
  746.     cards are not directly VESA compliant and need a tsr to be run
  747.     before they will work with Executor/DOS.  On a Gateway
  748.     computer, you can do this with the "vprmode VESA" command.
  749.  
  750.  
  751. [3]  Executor/Linux
  752. ===================
  753.  
  754. [3.1]  Can I buy the Linux version now?
  755. ---------------------------------------
  756.  
  757.     (Technically, our software is licensed, not sold) You can now
  758.     license Executor/Linux and be provided with a serial number
  759.     and license key from ARDI and "unlock" the experimental
  760.     Executor 1.99<x> releases as well as Executor/Linux 2.0.*.
  761.     However, currently there is no printed manual available for
  762.     Executor/Linux.
  763.  
  764.  
  765. [3.2]  Why can't the Linux version access floppies with option-shift-2
  766. ----------------------------------------------------------------------
  767.         (like  the DOS version does)?
  768.         -----------------------------
  769.  
  770.     This problem was fixed in Executor/Linux 1.99j.
  771.  
  772.  
  773. [3.3]  Are we ready to hear about Executor/Linux bugs?
  774. ------------------------------------------------------
  775.  
  776.     Yes.  Send them to "bugs@ardi.com" and make sure that you
  777.     identify what version of Executor you're running (i.e.
  778.     Executor/Linux 1.99b) as well as what kernel and X-Windows
  779.     you're using.  Please mention what Mac software you were
  780.     running when you encountered the bug and explain whether the
  781.     bug is reproducible or not.  If Executor provides some sort of
  782.     debug output, please include that as well.  Our NEXTSTEP
  783.     version has a bug-sending facility that automatically fills in
  784.     all that information for you.  If we get some time, we'll
  785.     incorporate that code into Executor/Linux.
  786.  
  787.     Executor 1.99j is bundled with a "send-pr" package that allows
  788.     you to submit bug reports directly into our "gnats" bug
  789.     tracking database.  We prefer that you use this tool, although
  790.     it's not necessary.  See [3.4] for more information.
  791.  
  792.  
  793. [3.4]  Should bug reports be sent one at a time or in a big list?
  794. -----------------------------------------------------------------
  795.  
  796.     In general, it's easier for *us* if you send them one at a
  797.     time.  Internally we use "gnats", a free bug-tracking tool and
  798.     we need to separate each bug into a single file for tracking.
  799.     On the other hand, since by providing us with bug reports
  800.     you're helping us out, we won't refuse bug reports that are
  801.     collections.
  802.  
  803.     In fact, if you're particularly brave, you can pick up the
  804.     file "send-pr.tar.gz" and install a program "send-pr" which
  805.     will allow you to send us bug reports pre-formatted for gnats.
  806.     This will save us time and also give you a bug tracking number
  807.     that you can refer to in further e-mail to ARDI about the bug.
  808.  
  809.  
  810. [3.5]  Why is there no Executor for NetBSD or FreeBSD?
  811. ------------------------------------------------------
  812.  
  813.     We don't currently have the manpower to support it.  The Linux
  814.     release is a byproduct of the fact that we use Linux in house.
  815.     After we've cleaned up the Linux version and get some
  816.     Executor/Linux sales, we'll look into the feasibility of Executor
  817.     for NetBSD and FreeBSD.
  818.  
  819.  
  820. [3.6]  Where are the bitmaps stored on the Linux version of executor?
  821. ---------------------------------------------------------------------
  822.  
  823.     All versions of executor maintain an internal bitmap
  824.     corresponding to the actual screen.  We accrue a "dirty rect"
  825.     as the program draws to what it thinks is the screen via
  826.     Executor's QuickDraw implementation.  We periodically update
  827.     the _real_ screen (e.g., the X window) by transferring the
  828.     "dirty rect" across.  So basically our graphics interface to
  829.     the host machine consists of nothing more than blitting
  830.     rectangles to the screen, which aids our portability.  Under
  831.     X, we use shared memory extensions for speed, but we don't do
  832.     anything fancy like trying to cache Mac fonts on the X server
  833.     side.  Spending time trying to do so would be a bad idea for a
  834.     number of reasons I won't go into.
  835.  
  836.     "Refresh" mode is useful when the program directly manipulates
  837.     the frame buffer itself.  In this mode, we periodically
  838.     analyze the internal screen memory to decide what has been
  839.     changed, and transfer the changed data to the real screen.
  840.  
  841.  
  842. [3.7]  Will there be an SVGALIB version of Executor/Linux in the future?
  843. ------------------------------------------------------------------------
  844.  
  845.     Probably.  Executor/Linux would clearly get a major
  846.     performance benefit from an SVGALIB implementation.  We are in
  847.     the process of rewriting our graphics and event handling code
  848.     so that it will be easy to add this sort of capability, but we
  849.     don't yet have a timetable for doing so.
  850.  
  851.  
  852. [3.8]  Why do all the non-Executor Windows get creepy colors when Executor
  853. --------------------------------------------------------------------------
  854.         is running?
  855.         -----------
  856.  
  857.     This is no longer true for recent versions of Executor.
  858.     Executor/Linux can run in two modes on 4- or 8-bit X servers.
  859.  
  860.       1) "private colormap" mode.  In this mode, Executor "takes
  861.          over" all colors on your screen when the cursor is in the
  862.          Executor window.  That means that the colors for all your
  863.          other windows will suddenly change radically.  This is
  864.          the fastest mode, and provides the most accurate colors,
  865.          but it can be a real eyesore.  Still, if you're playing
  866.          Wolfenstein 3D or some other interactive game, you may
  867.          want to maximize performance by using this mode.  You can
  868.          enable this mode with "-privatecmap".
  869.       2) "non-private colormap" mode.  In this mode (the default),
  870.          Executor coexists nicely with other X windows by not
  871.          mucking about with the colors they use.  This mode loses
  872.          some accuracy and speed, because Executor cannot set the
  873.          entire color table to exactly what it wants and it must
  874.          convert its internal graphics representation to one
  875.          appropriate for the X screen whenever it updates your
  876.          display.  We have carefully optimized this conversion
  877.          process, so you won't notice the performance penalty most
  878.          of the time.
  879.  
  880.     The "-privatecmap" flag is irrelevant to 16, 24, and 32-bit X
  881.     servers, since they don't have a color table.
  882.  
  883.  
  884. [3.9]  How does printing work under Executor/Linux?
  885. ---------------------------------------------------
  886.  
  887.     Executor expects to print to a PostScript printer, or to send
  888.     output to a PostScript compatible filter, like GhostScript.
  889.     When an applicaton prints under Executor, a PostScript stream
  890.     will be created and sent through the program "executor_filter"
  891.     which you can create by hand to "do the right thing", or "lpr"
  892.     if there is no "executor_filter" for Executor to run.
  893.  
  894.     On our systems, "lpr" automatically does the right thing, so
  895.     other than occasionally setting our "PRINTER" environment variable,
  896.     we don't have to do much to print from Executor.
  897.  
  898.     If you need to write your own filter, you can test it by typing:
  899.  
  900.         ./myfilter < myfile.ps
  901.  
  902.     where "myfile.ps" is some PostScript file you have lying
  903.     around.  The "<" is VERY important!  Executor does NOT give
  904.     your filter any command line arguments; it just "pipes" the
  905.     PostScript file through it.
  906.  
  907.     CAVEAT #1:  The output that is currently produces relies on some
  908.     "Encoding" changes that appear not to work with GhostScript.  As
  909.     such, certain characters are improperly mapped.  Word output for
  910.     example can not print apostrophes!  Yes, we know this is very bad
  911.     and are looking for a remedy.
  912.  
  913.     CAVEAT #2:  Different apps running under Executor have different
  914.     levels of success when printing.  As always, *especially* with the
  915.     experimental versions, try first to make sure Executor will do what
  916.     you want it to.
  917.  
  918.  
  919. [3.10] Why does Executor complain that it cannot find 'libXt.so.6'?
  920. -------------------------------------------------------------------
  921.  
  922.     If Executor complains as soon as you start it up, you are either
  923.     running an old version of Executor (prior to 1.99e, at least) or
  924.     you are running XFree86 2.x instead of XFree86 3.x.  Currently we
  925.     do not have the time to create two separate versions of E/L, so
  926.     use the "current" XFree86 server/libraries.
  927.  
  928.     It has been reported that you can install the XFree86 3.x shared
  929.     libraries and still use an XFree86 2.x server.  We have not
  930.     verified such trickery here at ARDI -- you're on your own.
  931.  
  932.     When E/L 2.0 is released, we'll reevaluate our "3.x" only policy
  933.     and if there are a significant number of XFree86 2.x users that
  934.     would like to run E/L, we'll consider offering a version that links
  935.     with the XFree86 2.x libraries.
  936.  
  937.  
  938. [4]  Executor/NEXTSTEP
  939. ======================
  940.  
  941. [4.1]  Why hasn't there been an Executor/NEXTSTEP release in a while?
  942. ---------------------------------------------------------------------
  943.  
  944.     Recently we've revamped how Executor handles graphics
  945.     internally.  This broke our NEXTSTEP support, so we have not
  946.     released a NEXTSTEP version in a while.  Since we have to
  947.     rewrite that part of Executor anyway, we are looking into some
  948.     NeXT tools that allow programs to implement very fast
  949.     graphics.  Before we can use these tools, we need some
  950.     information from NeXT which thus far has not been forthcoming.
  951.     Once we have that information, we will resume making NEXTSTEP
  952.     releases in lockstep with releases for other platforms.
  953.